home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / RAR.ZIP / RAR.DOC < prev    next >
Text File  |  1994-05-26  |  31KB  |  1,032 lines
  1.  
  2.  
  3.    RAR       multifunctional                     User's manual
  4.              integrated
  5.    v1.50     archive
  6.              manager
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                      Wellcome to RAR Archiver!
  13.  
  14.    The manual contains full description of RAR 1.50 using.
  15.  
  16.  
  17.  
  18.    Introduction
  19.  
  20.    RAR is powerfull tool that allows you manage archive files
  21. with original facilities such as full-screen interactive
  22. interface (including mouse, menus), NON-RAR archive support,
  23. common 'standard' interface with console command line options.
  24.  
  25.    The archiver RAR has original compression algorithm
  26. implemented. It provides higher compression ratio than usual
  27. archiving tools for PC. Also it realizes special archive type
  28. 'solid', that brings compression much higher.
  29.  
  30.    Chapter 1      "Installing and Configuring"
  31.  
  32.    This chapter describes how to install and configure RAR,
  33. gives information about technical requirements.
  34.  
  35.    1.1. Installation procedure
  36.  
  37.    RAR is distributed in self-extracting (SFX) archive named
  38. RAR?_???.EXE where version number represents for '?_???'.
  39.  
  40.    Before installing it's recommended to create directory for
  41. RAR and make it current.
  42.  
  43.    Then run RAR SFX-archive by typing RAR?_??? at the DOS
  44. prompt. It initiates self-extraction RAR files to the current
  45. directory.
  46.  
  47.    For example, on floppy disk A: you have got file
  48. RAR1_50.EXE, that means RAR 1.50. You can install it to
  49. your disk typing at the DOS prompt following commands:
  50.  
  51.    C:\> mkdir RAR
  52.    C:\> cd RAR
  53.    C:\RAR>
  54.  
  55.    You've just created new directory C:\RAR and made it
  56. current.
  57.  
  58.    Then run RAR self-extracting archive:
  59.  
  60.    C:\> A:RAR1_50.EXE
  61.  
  62.    You will be prompted with RAR archive comment. Press any
  63. key to continue, pressing ESC will cancel extraction.
  64.  
  65.    When extraction successfully finished RAR is ready to work.
  66.  
  67.    The archiver program itself is named RAR.EXE, all of
  68. archive managing functions realized there.
  69.  
  70.    You can add directory where located RAR.EXE to your DOS
  71. path variable. Then you will be able to run RAR while any
  72. directory is current.
  73.  
  74.  
  75.    1.2. Option menu
  76.  
  77.    You can set up RAR options and save it to RAR.CFG for
  78. future use running RAR.EXE. Just type at your DOS prompt to
  79. start RAR in full-screen mode:
  80.  
  81.    C:\RAR> RAR
  82.  
  83.    When RAR started press F9 - you will enter follow menu:
  84.  
  85.           ┌─────────────────────────────────┐
  86.           │ Configuration...                │
  87.           │ Set password              ALT-P │
  88.           │ Work directory            ALT-W │
  89.           │ Default comment file            │
  90.           │ External viewer                 │
  91.           │ Change disk               ALT-D │
  92.           │ Registration                    │
  93.           │ Save options              ALT-S │
  94.           └─────────────────────────────────┘
  95.  
  96.    Press <Enter> to get sub-menu "Configuration". You will see
  97. configuration options with fields, that can be marked.
  98.  
  99.    There you can set up options going through items by
  100. pressing arrows, setting option values by typing key <Space>.
  101. When you've set up all desired options, to enroll them move to
  102. the field "[ Ok ]" and press <Enter> or simply press <Enter>
  103. anywhere except the field "[ Cancel ]". If you're going to
  104. leave option values unchanged go to the field "[ Cancel ]" and
  105. then press <Enter>.
  106.  
  107.    If you are using mouse, you can do this with comprehensive
  108. mouse-interface: move the mouse cursor and click mouse key.
  109.    When you're about finish configuring click mouse key upon
  110. field "[ Ok ]". Opposite, if you're going discard changes
  111. click mouse key upon field "[ Cancel ]".
  112.  
  113.  
  114.    "Configuration/Screen & Mouse"
  115.  
  116.      Enable color           Marking this option enables using
  117.                             colors in full-screen mode
  118.  
  119.      Enable mouse           This enables using of mouse in
  120.                             full-screen mode
  121.  
  122.      Stdout mode            This forces RAR to run in console
  123.                             (stdout) mode while processing
  124.                             commands from command line
  125.  
  126.    "Configuration/Put AV"
  127.  
  128.      Put auth. verification This forces RAR to place
  129.                             authenticity verification when
  130.                             creating archive (registered
  131.                             version only)
  132.  
  133.  
  134.    "Configuration/Compression"
  135.  
  136.    You can choose compression level marking one of the
  137. following:
  138.  
  139.      Store         Do not compress file when adding to archive
  140.      Fastest       Use fastest method (less compressive)
  141.      Fast          Use fast compression method
  142.      Normal        Use normal (default) compression method
  143.      Good          Use good compression method (more compressive)
  144.      Best          Use best compression method
  145.  
  146.  
  147.    "Configuration/Sort names"
  148.  
  149.    Choosing name sort way for archive content list mark one
  150. of the following:
  151.  
  152.      Unsorted      Do not sort files
  153.      By name       Sort files by name
  154.      By extension  Sort files by extension
  155.      By size       Sort files by sizes
  156.  
  157.  
  158.    "Configuration/Backup archive"
  159.  
  160.      Enable backup archive  This forces RAR to save archive
  161.                             file to .BAK before it changed
  162.  
  163.  
  164.    "Configuration/Include"
  165.  
  166.    To choose categories of files to be included when searching
  167. files for adding to archive you can mark:
  168.  
  169.      System files       Add files with 'System' attribute
  170.      Hidden files       Add files with 'Hidden' attribute
  171.      Read only files    Add files with 'Read-only' attribute
  172.      Archive files      Add files with 'Archive' attribute
  173.      Empty directories  Add empty directories
  174.  
  175.    For more information about file attributes refer to your
  176. DOS manual.
  177.  
  178.  
  179.    "Set password"
  180.  
  181.    You can assign password that will used when you add or
  182. extract files to (from) archive. Also you can enter password
  183. using <Alt/P>. Note, the password will not be saved to
  184. configuration file.
  185.  
  186.  
  187.    "Work directory"
  188.  
  189.    You can assign path where RAR to place temporary created
  190. files. It can be done by pressing <Alt/W>.
  191.  
  192.  
  193.    "Default comment file"
  194.  
  195.    If you need common comment be added to every archive you are
  196. creating you should enter it's name with full path.
  197.  
  198.  
  199.    "External viewer"
  200.  
  201.    You can assign external viewer program to run for viewing
  202. file from archives (by pressing <F3>).
  203.  
  204.    RAR stores default configuration in file RAR.CFG, placed in
  205. the same directory RAR.EXE was started from.
  206.  
  207.  
  208.    "Change disk"
  209.  
  210.    You can change current disk displaying in work window.
  211.  
  212.  
  213.    "Registration"
  214.  
  215.    To register one should have a register code, which can be
  216. obtained after sending registering fee and completed register
  217. form to author or a dealer. After registration user can put
  218. authenticity verification to archives.
  219.  
  220.  
  221.    "Save setup"
  222.  
  223.    After pressing <Enter> or clicking mouse key on this item
  224. user can choose "[ Save ]" or "[ Cancel ]". It means to save
  225. or cancel saving configuration for future use in RAR.
  226.  
  227.    Also you can save configuration pressing <Alt/S> (that
  228. means pressing keys <Alt> and <S> at the same time).
  229.  
  230.    Additionally you can set options using mouse directly on
  231. the right bottom part of the screen in window "Settings":
  232.  
  233.                    ├────────────── Settings ─────────────╢
  234.                    │   Password                 Absent   ║
  235.                    │   Compression level        Normal   ║
  236.                    │   Archive backup           Disabled ║
  237.                    │   Making AV archives       Enabled  ║
  238.                    │   Default comment file     Present  ║
  239.                    ┴─────────────────────────────────────╢
  240.  
  241.    For example, click mouse key on word 'Absent' on setting
  242. 'Password', you will be asked to enter password etc.
  243.  
  244.  
  245.    1.3. RAR environment variable
  246.  
  247.    You can describe your RAR environment variable using DOS
  248. SET command, for example:
  249.  
  250.    C:\> SET RAR=-std -s
  251.  
  252.    RAR would use this string as default parameters in command
  253. line.
  254.  
  255.    First RAR looks to the command line switches, then to the
  256. switches in environment variable string, then options saved in
  257. RAR.CFG.
  258.  
  259.    Switches -sfx, -v, -s, -std from RAR variable do no effect in
  260. full-screen mode.
  261.  
  262.  
  263.    1.4. Technical requirements
  264.  
  265.    Minimum DOS version to run RAR: 3.0
  266.  
  267.    Version specific (for RAR 1.50) conventional memory
  268. requirements:
  269.  
  270.    Starting RAR:                       260 Kb
  271.  
  272.    Extracting and viewing comments:    320 Kb
  273.  
  274.    Creating and updating archives:     420 Kb
  275.  
  276.    Managing non-RAR archives:          260 Kb
  277.  
  278.    (for extraction and updating non-RAR archives plus memory
  279.    that external archiver needs itself)
  280.  
  281.  
  282.    Chapter 2     "Using RAR interactively"
  283.  
  284.    When you start RAR by single command "RAR" at DOS prompt,
  285. you get ability to work with RAR full-screen interface. It
  286. means "running RAR interactively in full-screen mode".
  287.  
  288.    For example, you enter:
  289.  
  290.    C:\> RAR
  291.  
  292.    When RAR started on the right part of the screen you can
  293. see information box with memory status and settings window:
  294. current compression method, password status (absent or
  295. present), archive back up mode, authenticity verification
  296. status (enabled/disabled), whether default comment file
  297. present or not.
  298.  
  299.    On the left part of the screen you see current directory
  300. files. You can move cursor through the files on the screen
  301. using arrow keys or clicking the mouse.
  302.    If you press <Enter> when cursor is on a directory,
  303. up-directory ("..") or archive file you enter.
  304.    Archive can be one of the following types: .rar, .arj .zip,
  305. .lzh (or .ice).
  306.    After you enter archive it is shown like a subdirectory
  307. structure.
  308.    So you can "walk" through directories and archive files,
  309. managing files in archives or in normal directories.
  310.  
  311.    At bottom of the screen you can see available functions
  312. line:
  313.  
  314. 1Help 2Add 3View 4Fresh 5Volume 6Move 7Update 8Repair 9Option 0Quit
  315.  
  316.    The line indicates you can get help pressing <F1>, add
  317. files to archive pressing <F2>, view file by <F3> etc. Press
  318. <F10> to quit. These functions are main set when you are in
  319. directory (not in archive).
  320.  
  321.    Alternatively when you press <Alt> you see additional
  322. available functions line:
  323.  
  324. 1     2Solid 3View.. 4      5SFXVol 6SolVol 7SolSVl  8  9  0
  325.  
  326.    It means you can create solid archive pressing <Alt/F2>,
  327. call internal viewer to view file by <Alt/F3> etc.
  328.    Besides, when you hold <Alt> you can see options list in
  329. right bottom part of the screen:
  330.  
  331.    Alt-D  Select drive
  332.    Alt-C  Toggle between color and black and white mode
  333.    Alt-M  Select compression method
  334.    Alt-P  Set password
  335.    Alt-W  Set work directory to store temporary files
  336.    Alt-S  Save setup
  337.  
  338.    When you press other keys (not options and functions),
  339. you get file names speed searching. By <Ctrl-Enter> you
  340. can list all matches.
  341.  
  342.    You could see that available functions line differs whether
  343. you are in archive (when you "walk" trough archive contents)
  344. or in normal directory structure.
  345.  
  346.    When you are in archive available functions line looks
  347. like:
  348.  
  349. 1Help 2Test 3View 4Extr 5Commen 6ExCurD 7SFX  8   9Option 0Quit
  350.  
  351.    This line indicates you can get help pressing <F1>, test
  352. files in archive pressing <F2>, view file by <F3> etc. Press
  353. <F10> to quit. These functions are main set when you are in
  354. archive.
  355.  
  356.    Alternatively when you holding down <Alt> would cause next
  357. string:
  358.  
  359. 1     2      3View.. 4ExtrTo 5FilCmt 6SolVol 7Lock  8   9   0
  360.  
  361.    Use <Space>, <Ins>, or right mouse key to mark/unmark file
  362. group. You can use either to mark/unmark file group by
  363. wildcards (file mask) using <Gray +> and <Gray -> keys (on the
  364. numeric keypad). When you mark directory, you mark all
  365. directories and files in it if one. You can reverse marking
  366. files group by <Gray *>. When you mark on or more files you
  367. are prompted in bottom line how many files and directories
  368. you've marked and summary file size in bytes. (Note, in
  369. current version file size from marked directories does not
  370. include in summary file size).
  371.    In full-screen mode mouse is supported. Use left mouse key
  372. to move up trough the directory. Click mouse key twice to
  373. <Enter>. Use right mouse key to mark files. While entering
  374. text (archive name, password etc.) left mouse key cancel and
  375. right one ensures text entered. Use left mouse key to choose
  376. function commands (F1-F10) of menu items and options.
  377.  
  378.    2.1. When you are in directory
  379.  
  380.    Function keys actions:
  381.  
  382.      F1       Get help info
  383.  
  384.      F2       Add file(s) to archive, if archive does not exist
  385.               it will be created
  386.  
  387.      F3       View a file (if external viewer is not set,
  388.               internal viewer will be called)
  389.  
  390.      F4       Freshen files in archive - only recently changed files
  391.               will be added that already were in archive
  392.  
  393.      F5       Create archive volumes
  394.  
  395.      F6       Update files in archive - update (add) files if they
  396.               are recently changed or do not present in archive
  397.  
  398.      F7       Move file(s) to archive
  399.  
  400.      F8       Try to repair broken archive
  401.  
  402.      F9       Set up / Save options
  403.  
  404.      F10      Quit RAR. You can either press ESC.
  405.  
  406.      Alt-F2   Create solid archive.
  407.  
  408.      Alt-F3   View file (with internal viewer).
  409.  
  410.      Alt-F5   Create SFX-volumes.
  411.  
  412.      Alt-F6   Create solid archive volumes.
  413.  
  414.      Alt-F7   Create solid SFX-volumes.
  415.  
  416.  
  417.    2.1. When you are in archive
  418.  
  419.    Press <Enter> when standing on archive to get in. You can
  420. get in archive either running RAR with command 'en'. (See
  421. Chapter 3, 'en' command)
  422.  
  423.    When you are in archive it's files are shown on the left
  424. part of the screen (like files in directory). You can mark
  425. them as files in directory.
  426.  
  427.    File encrypted with password shown with asterisk '*' before
  428. it's name.
  429.  
  430.    On the right part of the screen information box is shown.
  431. It includes information: archive name and status, whether
  432. comments are present, if there are files encrypted with
  433. password, total number of files in archive, file sizes,
  434. compression ratio, minimum RAR version needed to extract, host
  435. OS archive was created with.
  436.  
  437.    For example:
  438.  
  439.    Info BOX:                Meaning:
  440.  
  441. Archive    EXAMPLE.RAR  - archive name
  442. Archive type    Normal  - not 'solid' archive
  443. Main comment   Present  - archive comment present
  444. File comments   Absent  - no file comments
  445. Passwords       Absent  - no password encrypted files
  446. Lock            Absent  - archive is not locked
  447. Auth. verif.   Present  - authenticity verification present
  448. Files                1  - number of files (1)
  449. Total length     14917  - total length in bytes
  450. Packed length     3938  - length in archive
  451. Ratio              26%  - compression ratio
  452. Version to extr.  1.30  - minimum version to extract needed
  453. Host OS         MS-DOS  - OS archive was created with
  454.  
  455.  
  456.    Function keys actions:
  457.  
  458.      F1       Get help info
  459.  
  460.      F2       Test archive
  461.  
  462.      F3       View a file (if external viewer is not set,
  463.               internal viewer will be called)
  464.  
  465.      F4       Extract files from archive with directory
  466.               structure
  467.  
  468.      F5       Add comment to archive
  469.  
  470.      F6       Extract file(s) to current directory
  471.  
  472.      F7       Make SFX-archive
  473.  
  474.      F8       Delete file(s) from archive
  475.  
  476.      F9       Set up / Save options
  477.  
  478.      F10      Return from archive. You can either press ESC.
  479.  
  480.      Alt-F3   View a file (with internal viewer)
  481.  
  482.      Alt-F4   Extract file(s) to alternate path
  483.  
  484.      Alt-F5   Add file comment(s)
  485.  
  486.      Alt-F7   Lock archive preventing it's modifications
  487.  
  488.  
  489.    When you work with archive volumes in full-screen mode you
  490. need to begin process with the first one, you will be prompted
  491. with menu:
  492.  
  493.    "Proceed with all volumes from current"
  494.    "Proceed with selected files only"
  495.  
  496.    Choose way you want work with volumes.
  497.  
  498.    It would be problematic process all volumes for marking
  499. files because they could be on different disks.
  500.  
  501.    When you watch files which were split between archive
  502. volumes compressed size listed means the size in current
  503. volume. This case indicates symbol '' when file parts
  504. located on previous volumes and symbol '' when some parts
  505. located on next volumes, both symbols appear when no
  506. previous and next parts in current directory.
  507.  
  508.    Chapter 3    "Using RAR with command line"
  509.  
  510.    Command line mode is opposite to full-screen interactive
  511. mode. It is available when you call RAR with parameters in
  512. command line.
  513.  
  514.    Usage:
  515.  
  516.  
  517.     rar <command> -<switch1> -<switchN> <archive> <files...>
  518.         <@listfiles...> <=comment_file> <path_to_extract\>
  519.  
  520.    Command can be one only, however it can applied by a number
  521. of switches.
  522.  
  523.    Archive means archive name.
  524.  
  525.    Files means list of files to be processed.
  526.  
  527.    File listfiles includes file names delimited with spaces
  528. or carriage return, this equivalent to using files.
  529.  
  530.    File comment_file includes comment adding to archive
  531. while creating archive, but not when modifying.
  532.  
  533.    Parameter path_to_extract is used only with commands 'e'
  534. and 'x', indicating directory to put extracted files.
  535. When the directory path_to_extract doesn't exist it will
  536. be created.
  537.  
  538.    3.1. Commands
  539.  
  540.     a: add files to archive
  541.  
  542.     m: move files and directories to archive
  543.  
  544.    Moving files and directories would be erased when
  545. packing successfully finished. Directories will not
  546. removed if switch '-ed' used.
  547.  
  548.     mf: move files to archive
  549.  
  550.    Moving files would be erased when packing successfully
  551. finished.
  552.  
  553.     d: delete files from archive
  554.  
  555.     x: extract files from archive with stored directories
  556.        if one
  557.  
  558.     e: extract files from archive to current directory
  559.  
  560.     v: verbosely list archive content (full form)
  561.  
  562.    Files are listed in format: full pathname, file comment,
  563. original and compressed size, compression ratio, last update
  564. date and time, attributes, CRC, compression method and minimum
  565. RAR version needed to extract will displayed.
  566.  
  567.    If you want to list all archive volumes, you need to use
  568. '*' instead of archive file extension. For example:
  569.  
  570.      rar v multivol.*
  571.  
  572.     l: list archive content (short form)
  573.  
  574.    Files are listed as with 'v' commands, but full file path
  575. not be displayed, only file names.
  576.  
  577.     t: test archive files
  578.  
  579.    This command performs test extraction (files will not
  580. extracted to disk).
  581.  
  582.     u: update files in archive
  583.  
  584.    Adds files those not in archive and updates those files
  585. recently changed since they were packed to archive.
  586.  
  587.     f: freshen files in archive
  588.  
  589.    Updates files in archive recently changed since they were
  590. packed.
  591.  
  592.     p: print file(s) to screen (STDOUT)
  593.  
  594.     s: convert archive to SFX-type (*.exe)
  595.  
  596.    You can also make SFX first volume from volume sequence,
  597. but note it's size would increased by volume of SFX-module. Be
  598. sure first volume in sequence would have proper size to be
  599. placed on floppy disc if needed. You can make SFX volumes
  600. using command 'a' with switches: '-v[<size>] -sfx'.
  601.  
  602.    For example:
  603.  
  604.        rar s diamant
  605.  
  606.     en: start RAR in full-screen mode and enter archive
  607.  
  608.    Usually this command included in extension file of shell
  609. Norton Commander: RAR: RAR en !.!
  610.  
  611.    Examples:
  612.  
  613.        rar en disk1.rar
  614.  
  615.        rar en puppy.zip
  616.  
  617.    You can omit 'en' (starting rar with archive name)
  618.  
  619.    Example:
  620.  
  621.        rar baby.arj
  622.  
  623.     c: add archive comment
  624.  
  625.    Press <F10> to save entered comment and exit. Press <Esc>
  626. to cancel comment. Pressing <F10> immediately after processing
  627. this command would erase existing comment.
  628.  
  629.    Comments are displayed while archive processing. Maximum comment
  630. size is 16 kilobytes.
  631.  
  632.    In comment file RAR provides ANSI-sequences support
  633. implemented. It allows use color and cursor movements in
  634. comments. It doesn't require ANSI driver when comment
  635. displayed.
  636.  
  637.    ANSI-sequences programming keyboard are not implemented.
  638. Though they would canceled when detected. It protects user
  639. against ANSI-bombs, when a key programming to dangerous
  640. command such as "echo y | del *.*".
  641.  
  642.    Example:
  643.  
  644.        rar c distrib.rar
  645.  
  646.    Comments could be entered from file, if in command line
  647. before it stands '=' symbol (see usage). For example:
  648.  
  649.        rar c dummy =info.txt
  650.  
  651.     cf: add file comments (not to entire archive)
  652.  
  653.    When comment is entered press <F10> to save it. <Esc> will
  654. cancel comments entering. Press <F10> immediately after
  655. starting entering mode to erase existing comment.
  656.  
  657.    Comments are displayed when 'v' command processed. Comment
  658. size is limited to 16 kilobytes.
  659.  
  660.    Example:
  661.  
  662.        rar cf bigarch *.txt
  663.  
  664.     cw: write archive comment to a file
  665.  
  666.    For example:
  667.  
  668.        rar cw oldarch comment.txt
  669.  
  670.    Comment from archive oldarch.rar will be written to file
  671. comment.txt
  672.  
  673.     r: repair broken archive
  674.  
  675.    RAR could not restore loosed file information. So you could
  676. not repair files with message when extracted "CRC failed".
  677. However you can repair broken archive to access probably not
  678. damaged files, or if you getting 'hook' RAR while processing
  679. archive.
  680.  
  681.    After processing this command would create new archive file
  682. named $RECOVER.RAR. While repairing archive RAR could find
  683. strange entries then user will be prompted with:
  684.  
  685.                       Suspicious entry
  686.  
  687.               Name:  <possibly filename>
  688.               Size:  <size>    Packed: <compressed size>
  689.  
  690.                       Add it: Yes/No/All
  691.  
  692.    Answer 'Y' to add this entry to file $RECOVER.RAR.
  693.  
  694.    Example:
  695.  
  696.        rar r buggy.rar
  697.  
  698.     k: lock archive
  699.  
  700.    Any commands that could change archive will cancelled.
  701.  
  702.    Example:
  703.  
  704.        rar k final.rar
  705.  
  706.  
  707.    Commands 'd','u','f' will not work with archive volumes
  708. and solid archives.
  709.    Command 'a' could not be used to update archive volumes and
  710. solid archives, only to create one.
  711.  
  712.    Commands 'c' and 'cf' will not work with archive volumes, but
  713. will work with solid archives.
  714.  
  715.    Archive comment could be added while archive creation using
  716. comment file.
  717.  
  718.    3.2. Switches
  719.  
  720.     -?   print help on commands and switches
  721.  
  722.     -r   recourse subdirectories
  723.  
  724.    Could be used with commands: a,u,f,m,x,e,t,p,v,l,c,cf,s.
  725.  
  726.    When using with commands 'a', 'u', 'f', 'm' causes adding
  727. to archive files including those in sub-directories.
  728.  
  729.    When using with commands x,e,t,p,v,l,c,cf,s will cause
  730. processing all archives including those in sub-directories.
  731.  
  732.     -o+  overwrite existing files
  733.  
  734.     -o-  do not overwrite existing files (default)
  735.  
  736.     -x<mask>    exclude files specified by mask
  737.  
  738.    Example:
  739.  
  740.          rar a -x*.bak purearch.rar
  741.  
  742.  
  743.     -x@<list>   exclude files using specified list file
  744.  
  745.    Example:
  746.  
  747.          rar a -x@exlist.txt arch *.exe
  748.  
  749.  
  750.     -sfx create SFX archives
  751.  
  752.    If this switch used while creating new archive SFX-archive
  753. would created.
  754.  
  755.    For example, command:
  756.  
  757.          rar a -sfx sources *.asm
  758.  
  759.    would create SFX-archive sources.exe. To extract file from such
  760. archive you could only execute it. Such archive can be processed
  761. also with RAR.
  762.  
  763.     -v  create volumes with autodetected size
  764.  
  765.     -v<size> create archive volumes
  766.  
  767.    By default this switch uses <size> in thousands of bytes
  768. (not kilobytes). You can also enter size in kilobytes using
  769. symbol 'k' after it. If size is omitted it would cause
  770. size autodetection.
  771.  
  772.    If volumes are created in the same disk where temporary
  773. files located (current disk by default, possibly to change it
  774. by switch '-w'), you can not change disk. Then autodetected
  775. size is nonsense and size must be indicated explicitly.
  776.  
  777.    If volumes are created not on the same disk with temporary
  778. files, then after one volume is created user will be prompted:
  779.  
  780.            Create next volume: Yes/No/All/Quit
  781.  
  782.    In this moment you can change floppy disk. If you've
  783. answered 'A' - all volumes would created without pauses.
  784.  
  785.    First volume file has extension .rar, next are numerated
  786. from .r00 to .r99.
  787.  
  788.    When you extract or test multi-volume archive you can use
  789. only first volume name (*.rar). If there are no next volume in
  790. the disk (and volumes placed not in the same directory with
  791. temporary files), user will prompted:
  792.  
  793.            Insert disk with <next volume name>
  794.  
  795.    Insert disk with the volume and press any key.
  796.  
  797.    If while extraction next volume not found and volumes
  798. placed in the same directory with temporary files RAR will
  799. abort with error message:
  800.  
  801.            Can't find <volume name>
  802.            Can't change disk with temporary files
  803.  
  804.    Archive volumes cannot be modified. Commands 'd', 'f', 'u',
  805. 's' can not apply to them. Command 'a' can be used only
  806. for creating new volumes sequence.
  807.  
  808.    Compressed file size in archive volumes could sometimes be
  809. greater than source (uncompressed) size, because storing (do
  810. not compress if compression failed) not enabled in volumes.
  811.  
  812.    Archive volumes can be SFX, you should create such archive
  813. using both '-v' and '-sfx' switches.
  814.  
  815.  
  816.    Example:
  817.  
  818.    1. Archive disk C: on floppy disks A:
  819.  
  820.            rar a -r -v a:allhard c:\*.*
  821.  
  822.    (current disk MUST be C:)
  823.  
  824.    2. Create archive volumes with 362000 byte size in current
  825. directory.
  826.  
  827.            rar a -v362 4flopp
  828.  
  829.    or
  830.  
  831.            rar a -v362 4flopp *.*
  832.  
  833.  
  834.     -w<path>  assign work directory
  835.  
  836.    It is useful to assign electronic disk or path with high
  837. performance disk input/output as work directory.
  838.  
  839.    Note, if file cannot be created in current directory, RAR
  840. would search available disk automatically.
  841.  
  842.    Example:
  843.  
  844.            rar a -we:\tmp bmps *.bmp
  845.  
  846.    Temporary files would be created in E:\TMP
  847.  
  848.  
  849.     -p<password> set password
  850.  
  851.     -p           set password
  852.  
  853.    Letters in password are case-sensitive. If you omit password
  854. after switch it will be asked by query:
  855.  
  856.             Enter password:
  857.  
  858.    Example:
  859.  
  860.            rar a -pmyhoney secret *.txt
  861.  
  862.    Newly added files will be encrypted with password 'myhoney'.
  863.  
  864.     -y   assume Yes on all queries
  865.  
  866.     -std  stdout mode
  867.  
  868.    All output text do in stdout form. It allows to reassign
  869. RAR output to file, for example:
  870.  
  871.             rar v -std bambam >bambam.lst
  872.  
  873.    or you could process without any output:
  874.  
  875.             rar x -std dime 10cents.txt >nul
  876.  
  877.     -m<0..5> set compression method
  878.  
  879. -m0   store     do not compress file when adding to archive
  880. -m1   fastest   use fastest method (less compressive)
  881. -m2   fast      use fast compression method
  882. -m3   normal    use normal (default) compression method
  883. -m4   good      use good compression method (more compressive)
  884. -m5   best      use best compression method
  885.  
  886.    By default RAR uses -m3 method (Normal compression).
  887.  
  888.     -col  color mode
  889.  
  890.     -bw   black & white mode
  891.  
  892.     -b    enable backup archives
  893.  
  894.    This case archive before updating will be stored in copy
  895. with .bak extension. If archive named with .bak extension,
  896. backup copy will have .$bk extension.
  897.  
  898.     -f    freshen files
  899.  
  900.    Could be used with archive extraction or creation.
  901.  
  902.    Command string "a -f" is equivalent to command 'f',
  903. you could use switch '-f' with commands 'm' or 'mf'.
  904.    If switch '-f' would using together with commands 'x' or
  905. 'e', then only old files should be replaced with new versions
  906. from archive.
  907.  
  908.     -u    update files
  909.  
  910.    Could be used with archive extraction or creation.
  911.  
  912.    Command string "a -u" is equivalent to command 'u',
  913. you could use switch '-u' with commands 'm' or 'mf'.
  914.    If switch '-f' would using together with commands 'x' or
  915. 'e', then only old files should be replaced with new versions
  916. from archive.
  917.  
  918.     -ed   don't add empty directories
  919.  
  920.    When using this switch empty directories will not be stored
  921. in archive, only directories with files.
  922.  
  923.     -ep   exclude paths from names
  924.  
  925.    When using this switch files with same (not unique) names
  926. can be added to archive from different directories.
  927.  
  928.     -ep1  exclude base dir from names
  929.  
  930.    Do not store path from command line.
  931.  
  932.    For example:
  933.  
  934.           rar a -ep1 -r basta tmp\*.*
  935.  
  936.    All files and directories from directory TMP will be added
  937. to archive 'basta', but path will not include 'TMP\'. It works
  938. equivalent to commands:
  939.  
  940.    cd tmp
  941.    rar a -ep1 -r basta
  942.    cd ..
  943.  
  944.    For proper working of this switch you have to use full form
  945. in path (from example before), but not command string:
  946. rar a -ep1 -r basta tmp
  947.  
  948.     -cfg- disable read configuration and environment
  949.  
  950.     -c-   disable comments show
  951.  
  952.     -e<s,h,a,r> set file exclude attributes
  953.  
  954.    If using 's', 'h', 'a' or 'r' it means do not look to file
  955. with types System, Hidden, Archive, Read only attributes
  956. accordingly.
  957.  
  958.    Attributes order is not significant.
  959.  
  960.    Example:
  961.  
  962.            rar a -ehs purity *.exe
  963.  
  964.    Means do not add files with Hidden and System attributes.
  965.  
  966.     -s    create solid archive
  967.  
  968.    Solid is special archive type, look to Appendix "Glossary".
  969.  
  970.    Example:
  971.  
  972.            rar a -s -v362 -sfx maddy *.*
  973.  
  974.    Will create solid SFX volumes 362000 size.
  975.  
  976.     -av   put authenticity verification (registered versions only!)
  977.  
  978.    This switch forces RAR to put in every created and updated
  979. archive information about author, last update time, archive name.
  980.  
  981.    If archive created with switch '-av' is being modified
  982. without this switch, authenticity verification information would
  983. be removed.
  984.  
  985.    When extracting, testing, listing archive, created or
  986. updated with '-av', RAR will check integrity of the archive
  987. and prompt user with message:
  988.  
  989.             Verifying authenticity information ...
  990.  
  991.    In case it successfully verified message 'Ok', creator name
  992. and last update information will be displayed. In case archive
  993. damaged message 'FAILED' will be displayed.
  994.  
  995.    When creating archive volumes with '-av' switch Cyclic
  996. Redundancy Check (CRC) will be added to every volume.
  997.  
  998.    Feature '-av' is recommended to use with archives for
  999. distributing software products.
  1000.  
  1001.    You have to register to obtain possibility using this
  1002. feature, because in this mode creator name stored in archive
  1003. which entered during registration.
  1004.  
  1005.      Glossary
  1006.  
  1007.  
  1008.    Archive       Special file containing one or more files
  1009.                  encoded that could be extracted from it.
  1010.  
  1011.    Compression   A method of encoding data to reduce
  1012.                  it's size.
  1013.  
  1014.    CRC           Cyclic Redundancy Check. Mathematic method
  1015.                  to store special checking information for
  1016.                  data validity.
  1017.  
  1018.    SFX           Archive module used to extract files from
  1019.                  when executed. (Self-extracting module).
  1020.  
  1021.    Solid         An archive packed with a special method
  1022.                  when archive program places to archive all
  1023.                  files compressed together as information
  1024.                  flow (as if they were parts of one file to
  1025.                  be compressed).
  1026.  
  1027.    Volume        Part of splitted archive. Splitting archive
  1028.                  to volumes allows store them apparently on
  1029.                  floppy disks. Volumes need to be extracted
  1030.                  starting from first one in sequence.
  1031.  
  1032.